TrgPortLine 연산자

Operator Library: Hardware Platform

이 오퍼레이터는 카메라의 트리거(Exsync)를 생성합니다. 또한 취득한 라인을 조합하여 이미지를 구성하는 역할을 합니다.

내부 신호 생성기(GrabberControlled)를 사용하거나, 트리거 확장 Board(TTL Trigger board 또는 OPTO Board)의 입력 신호 또는 소프트웨어를 통해 외부 신호로 신호 생성기를 트리거할 수 있습니다. 신호 생성기는 유연한 지연 시간, 펄스 폭 및 극성을 가진 Exsync 신호를 생성할 수 있습니다. 또한 트리거 확장 Board에서 사용할 수 있는 플래시 신호가 생성됩니다.

이 오퍼레이터는 4개의 디지털 출력과 CC 신호용 카메라 포트 1개를 차지합니다. 따라서 CameraControl 유형의 VisualApplets 리소스가 하나 사용됩니다. 리소스 인덱스가 0으로 설정된 경우, 디지털 출력 0~2 및 카메라 포트 A가 사용됩니다. 리소스 인덱스가 1로 설정된 경우, 디지털 출력 4~6 및 카메라 포트 B가 사용됩니다. 출력 3과 7은 오퍼레이터에서 사용되지 않습니다. 다른 오퍼레이터는 이러한 하드웨어 리소스를 사용할 수 없으므로 주의하시기 바랍니다. 리소스 대화상자에서 리소스 인덱스를 설정하십시오.

하드웨어 플랫폼별 지원 여부
microEnable IV VD1-CL/-PoCL
microEnable IV VD4-CL/-PoCL

I/O Properties

Property Value
Operator Type P
입력 링크 I, data input
출력 링크 O, data output

지원되는 Link Format

Link Parameter Input Link I Output Link O
Bit Width [1, 64] as I
Arithmetic {unsigned, signed} as I
Parallelism any as I
Kernel Columns 1 as I
Kernel Rows 1 as I
Img Protocol VALT_LINE1D VALT_IMAGE2D
Color Format any as I
Color Flavor any as I
Max. Img Width any as I
Max. Img Height 65536 as I

Parameters

YOffset
Type dynamic/static 읽기/쓰기 파라미터
Default 0
Range [0, 224]

이 파라미터는 프레임의 시작 부분에서 생략할 라인 수를 정의합니다.

YLength
Type dynamic/static 읽기/쓰기 파라미터
Default 1024
Range [8, 224]

이 파라미터는 프레임의 라인 수를 정의합니다.

MaxGatedHeight
Type 동적 읽기/쓰기 파라미터
Default restricted
Range {restricted, unrestricted}

이미지 트리거 모드(ImgTriggerMode)가 ExternSw_Gate로 설정된 경우, MaxGatedHeight 파라미터를 사용하여 최대 이미지 높이를 제한할 수 있습니다.

이미지 트리거 모드(ImgTriggerMode)가 ExternSw_Gate로 설정되고 MaxGatedHeight 파라미터가 unrestricted로 설정된 경우, 이미지 높이는 게이트가 열려 있는 시간, 즉 외부 이미지 트리거 신호의 펄스 폭 또는 소프트웨어 트리거의 지속 시간이 값 1인 시간에 의해 정의됩니다. 이제 게이트가 오랜 시간 동안 열려 있으면 이미지 높이가 커집니다. 파라미터 MaxGatedHeight가 restricted로 설정된 경우, 게이트가 계속 열려 있더라도 이미지 높이는 YLength 이미지 라인으로 제한됩니다. 오퍼레이터는 추가 라인을 폐기하고 다음 게이트가 열릴 때까지 기다려 새 프레임을 시작합니다.

반면에 파라미터가 unrestricted로 설정된 경우, 이미지 높이는 오직 게이트에 의해서만 정의됩니다.

[경고] 링크 속성 위반 가능성

unrestricted 모드에서 이 파라미터를 사용하면 VisualApplets 링크 프로토콜 위반이 발생할 수 있습니다. 이미지 높이가 TrgPortLine 오퍼레이터의 출력 링크에 정의된 최대 허용 이미지 높이를 초과할 수 있습니다. restricted 모드를 사용할 때는 주의하십시오. 링크 속성에 대한 자세한 내용은 'Link Properties'를 참조하십시오.

후속 SplitImage 오퍼레이터를 사용하면 큰 이미지를 청크(더 작은 이미지)로 나눌 수 있습니다.

LineTriggerMode
Type dynamic/static 읽기/쓰기 파라미터
Default GrabberControlled
Range {GrabberControlled, Extern_Trigger, GrabberControlled_Gated_by_Img, Extern_Trigger_Gated_by_Img}

이 파라미터는 내부 Exsync 신호 생성기의 작동 모드를 선택합니다. 외부 트리거 입력 소스는 LineTrgInSourceA 및 LineTrgInSourceB 파라미터를 통해 선택할 수 있습니다(아래 참조).

GrabberControlled: 내부 신호 생성기에 의해 주기적으로 Exsync가 생성됩니다.

Extern_Trigger: 외부 트리거 신호를 사용하여 신호 생성기를 한 번 시작합니다.

GrabberControlled_Gated_by_Img: 프레임 취득 중에 내부 신호 생성기에 의해 주기적으로 Exsync가 생성됩니다.

Extern_Trigger_Gated_by_Img: 프레임 획득 중 신호 생성기를 트리거하는 데 외부 트리거 신호가 사용됩니다.

ExsyncEnable
Type 동적 읽기/쓰기 매개변수
Default OFF
Range {OFF, ON}

카메라로 향하는 Exsync 출력을 활성화 또는 비활성화합니다.

LineTrgInSourceA
Type dynamic/static 읽기/쓰기 파라미터
Default InSignal0
Range {InSignal0, InSignal1, InSignal2, InSignal3, InSignal4, InSignal5, InSignal6, InSignal7}

이 파라미터는 Exsync 신호 생성기를 트리거하는 데 사용되는 신호 소스를 지정합니다. 이는 TriggerMode가 Extern_Trigger로 설정된 경우에만 유효합니다.

LineTrgInSourceB
Type dynamic/static 읽기/쓰기 파라미터
Default InSignal0
Range {InSignal0, InSignal1, InSignal2, InSignal3, InSignal4, InSignal5, InSignal6, InSignal7}

이 파라미터는 Exsync 신호 생성기를 트리거하는 데 사용되는 신호 소스를 지정합니다. 이는 TriggerMode가 Extern_Trigger로 설정되고 EncoderABMode가 Signal_AB_Filter로 설정된 경우에만 유효합니다.

EncoderABMode
Type dynamic/static 읽기/쓰기 파라미터
Default Signal_A_Only
Range {Signal_A_Only, Signal_AB_Filter, Signal_ABx2_Filter, Signal_ABx4_Filter}

이 파라미터는 Exsync 생성을 위해 단일 트리거 입력(A 전용)을 사용할지, 아니면 A와 B 신호 모두를 사용할지 지정합니다.

신호 A/B 지원을 사용하면 샤프트 엔코더의 회전 방향을 판별하고 역방향 이동을 억제 및 보정할 수 있습니다.

Signal_A_Only: LineTrgInSourceA에서 선택한 트리거 입력이 Exsync 생성에 사용됩니다.

Signal_AB_Filter: 단일 해상도에서 샤프트 엔코더가 정방향으로 회전할 때 Exsync가 생성됩니다(즉, LineTrgInSourceA의 상승 에지에 대한 트리거 펄스).

Signal_ABx2_Filter: 2배 해상도에서 샤프트 엔코더가 정방향으로 회전할 때 Exsync가 생성됩니다(즉, LineTrgInSourceA의 상승 에지 및 하강 에지에 대한 트리거 펄스). LineTrgInSourceA의 두 에지가 모두 사용됩니다.

Signal_ABx4_Filter: 4배 해상도에서 샤프트 엔코더가 정방향으로 회전할 때 Exsync가 생성됩니다(즉, LineTrgInSourceA의 상승 및 하강 에지, 그리고 LineTrgInSourceB의 상승 및 하강 에지에 대한 트리거 펄스).

AB 지원이 활성화된 경우의 관련 파라미터:

  • EncoderABLead (정방향 정의를 전환할 수 있는 기능)

EncoderABMode 파라미터를 Signal_A_Only 값으로 설정하여 샤프트 엔코더를 재설정할 수 있습니다.

EncoderABLead
Type dynamic/static 읽기/쓰기 파라미터
Default Signal_AB
Range {Signal_AB, Signal_BA}

파라미터가 Signal_AB로 설정된 경우, 정방향 이동은 신호 B보다 신호 A가 먼저 상승 에지를 가질 때로 정의되며, 그 반대의 경우도 마찬가지입니다.

Signal_AB: A가 B보다 먼저 발생하는 경우가 정방향입니다.

Signal_BA: B가 A보다 먼저 발생하는 경우가 정방향입니다.

LineTrgInPolarity
Type 동적 읽기/쓰기 매개변수
Default LowActive
Range {LowActive, HighActive}

이 파라미터는 외부 입력 Trigger 신호인 LineTrgInSourceA 및 LineTrgInSourceB의 극성을 정의합니다. LowActive로 설정된 경우, Exsync 제너레이터는 ImgTrgInSource 파라미터로 지정된 신호의 하강 에지에서 시작됩니다. 그렇지 않은 경우, Exsync 생성은 상승 에지에서 시작됩니다. 이는 Trigger Mode가 Extern_Trigger로 설정된 경우에만 유효합니다.

LineTrgDownscaler
Type dynamic/static 읽기/쓰기 파라미터
Default 1
Range [1, 256]

이 파라미터는 Exsync를 생성하는 데 필요한 외부 입력 Trigger 신호의 수를 지정합니다. 이는 Trigger Mode가 외부 트리거 모드로 설정된 경우에만 유효합니다.

LineTrgPhase
Type dynamic/static 읽기/쓰기 파라미터
Default 1
Range [1, 256]

이 파라미터는 프레임의 첫 번째 Exsync를 생성하는 데 필요한 외부 입력 Trigger 신호의 수를 지정합니다. 이는 Trigger Mode가 Extern_Trigger_Gated_by_Img로 설정된 경우에만 유효합니다.

ExsyncPeriod
Type dynamic/static 읽기/쓰기 파라미터
Default 100 μs
Range [1.024, 4000] μs

이 파라미터는 Exsync 신호의 주기를 지정합니다. 따라서 프레임 그래버 제어 모드를 사용하여 연결된 카메라를 트리거할 때 라인 주파수를 정의합니다.

ExsyncExposure
Type dynamic/static 읽기/쓰기 파라미터
Default 20 μs
Range [1.024, 2000] μs, ExsyncPeriod를 초과할 수 없음

이 파라미터는 많은 카메라에서 Exposure Time을 지정하는 데 사용할 수 있는 Exsync 신호의 펄스 폭을 지정합니다. 따라서 이미지 취득 중에도 소프트웨어를 통해 Exposure Time을 조절할 수 있습니다.

Exsync2Delay
Type dynamic/static 읽기/쓰기 파라미터
Default 0 μs
Range [0, 2000] μs, ExsyncPeriod를 초과할 수 없음

이 파라미터는 외부 Trigger 입력에 대한 생성된 Exsync 신호의 지연을 지정합니다. 따라서 Exsync2 신호는 Exsync의 지연된 복제본입니다(극성, 주기 등은 Exsync와 동일함).

ExsyncPolarity
Type dynamic/static 읽기/쓰기 파라미터
Default LowActive
Range {LowActive, HighActive}

이 파라미터는 연결된 카메라가 수용하는 극성에 맞게 Exsync 신호 제너레이터의 극성을 조절합니다. 카메라가 하강 에지에서 셔터를 열면 LowActive를 사용하고, 그렇지 않으면 HighActive를 사용하십시오.

ImgTriggerMode
Type dynamic/static 읽기/쓰기 파라미터
Default FreeRun
Range {FreeRun, ExternSw_Trigger, ExternSw_Gate}

이 파라미터는 내부 Image Gate의 작동 모드를 선택합니다.

이미지 트리거 입력 신호는 외부(주변) 장치(예: 샤프트 엔코더) 또는 소프트웨어에 의해 생성될 수 있습니다. 외부 이미지 트리거 입력 소스는 아래의 ImgTrgInSource 파라미터를 통해 선택할 수 있습니다.

ImgTriggerMode 파라미터의 값은 다음과 같은 동작을 유발합니다.

  • FreeRun:

    • 카메라에서 전송되는 모든 수신 라인이 허용됩니다.

    • Image Gate가 무시됩니다.

    • YLength 파라미터는 프레임 종료(EOF)가 생성되는 시점을 정의합니다.

    • yOffset 파라미터가 0보다 큰 경우, 연속된 두 이미지 사이의 yOffset 라인 수가 생략됩니다.

      예시: yOffset = 0, YLength = 2:

      예시: yOffset = 2, YLength = 2:

  • ExternSw_Trigger:

    • 허용된 이미지 트리거 입력 신호의 상승 에지에서, 새 프레임이 시작되고 수신된 라인이 YLength까지 이미지에 추가됩니다.

    • YLength 파라미터는 프레임 종료(EOF)가 생성되는 시점을 정의합니다.

    • 이미지 트리거의 새로운 상승 에지는 YLength 라인이 추가되고 EOF가 생성된 후에만 허용됩니다. 이미지에 YLength 라인이 추가되고 EOF가 생성되기 전에 이미지 트리거의 새로운 상승 에지가 발생하면 무시됩니다.

      예시: YLength가 값 2로 설정된 경우:

  • ExternSw_Gate:

    • 게이트 모드에서는 Image Gate 신호 역할을 하므로 이미지 트리거 입력 신호가 유지되는 시간이 중요합니다.

    • 이 모드의 정확한 동작은 MaxGatedHeight 파라미터로 정의할 수 있습니다. (MaxGatedHeight를 사용하여 이미지의 최대 이미지 높이를 제한할지 또는 제한하지 않을지 정의할 수 있습니다. 자세한 내용은 MaxGatedHeight 파라미터 설명을 참조하십시오.)

      MaxGatedHeight 파라미터가 "Unrestricted"로 설정된 경우 ExternSW_Gate 모드의 동작

      • Image Gate 신호가 활성화되어 있는 동안 수신된 라인이 이미지에 추가됩니다.

      • Image Gate는 유효한 이미지 라인을 제어합니다.

        • Image Gate 신호가 활성화되어 있는 동안 수신된 라인이 허용됩니다. (예: 그림의 n+8 및 n+9 라인 참조)

        • Image Gate 신호가 활성화되지 않은 동안 수신된 라인은 무시됩니다. (예: 그림의 n+3 라인 참조)

        • Image Gate 신호가 활성화된 상태에서 시작되는 각 라인은 유효합니다. (그림 참조: n+1, n+2, n+4, n+5, n+6, n+8 및 n+9는 유효합니다.)

          마지막 라인의 모든 데이터가 획득되기 전에 Image Gate의 하강 에지가 발생하더라도, 해당 라인은 유효하며 완전히 획득됩니다. (그림 참조: n+2 및 n+6)

        • 전송되는 라인은 항상 완전합니다.

        • Image Gate가 닫혀 있는 동안 시작되는 각 라인은 유효하지 않습니다. (그림 참조: 라인 n 및 n+7은 유효하지 않으며, 라인 n+4는 유효합니다.)

        • EoL(End of Line) 및 EoF(End of Frame)는 새 라인이 시작되기 직전 또는 Image Gate의 하강 에지에서 생성됩니다.

          EoL 직접 생성 (새 라인 시작 직전): 열린 Image Gate 내에서 라인의 하강 에지가 발생하고 Image Gate가 다음 라인의 시작 부분을 포함하는 경우, EoL은 다음 라인의 상승 에지 직전에 생성됩니다. (그림 참조: n+1, n+4, n+5, n+8)

          EoL 및 EoF 동시 생성 (새 라인 시작 직전): 라인의 하강 에지보다 Image Gate의 하강 에지가 먼저 발생하는 경우, EoL과 EoF는 다음 라인의 상승 에지 직전에 생성됩니다. (그림 참조: 이미지 m 및 이미지 m+1)

          EoL 및 EoF 동시 생성 (Image Gate 하강 에지): 열린 Image Gate 내에서 라인의 하강 에지가 발생하고 다음 라인의 상승 에지보다 Image Gate의 하강 에지가 먼저 발생하는 경우, EoL과 EoF는 Image Gate의 하강 에지 직후에 생성됩니다. (그림 참조: 이미지 m+2)

      파라미터 MaxGatedHeight가 "Restricted"로 설정된 경우 Mode ExternSW_Gate의 동작

      파라미터 MaxGatedHeight 이(가) "restricted"로 설정된 경우, 동작은 위에서 설명한 MaxGatedHeight 의 값이 "unrestricted"일 때와 동일하지만 다음 예외가 적용됩니다.

      • Image Gate가 열려 있는 동안에는 최대 이미지 높이인 YLength에 도달할 때까지 라인들이 추가됩니다. Image Gate 신호의 다음 상승 에지가 발생할 때까지 그 이후의 모든 라인은 생략됩니다.

      • YLength 라인이 추가되기 전에 Image Gate 신호의 하강 에지가 발생하는 경우: 이미지가 YLength 높이에 도달하지 못하더라도 Image Gate 신호의 하강 에지에 의해 이미지의 높이가 정의됩니다. (이미지 높이에 대한 자세한 내용은 파라미터 MaxGatedHeight 참조)

      • 아래 예시(그림)는 MaxGatedHeight = restricted 및 YLength = 3일 때의 동작을 보여줍니다.

ImgTrgInSource
Type dynamic/static 읽기/쓰기 파라미터
Default InSignal0
Range {InSignal0, InSignal1, InSignal2, InSignal3, InSignal4, InSignal5, InSignal6, InSignal7}

이 파라미터는 이미지 취득을 트리거하는 데 사용되는 신호 소스를 지정합니다. 이는 ImgTriggerMode가 ExternSw_Trigger 또는 ExternSw_Gate로 설정된 경우에만 유효합니다.

ImgTrgInPolarity
Type 동적 읽기/쓰기 매개변수
Default LowActive
Range {LowActive, HighActive}

이 파라미터는 외부 입력 트리거 신호의 극성을 정의합니다.

ImgTrgDelay
Type 동적 읽기/쓰기 매개변수
Default 0
Range {0, 4095}

이 파라미터는 지정된 이미지 라인 수만큼 이미지 트리거 신호를 지연시킵니다.

FlashEnable
Type 동적 읽기/쓰기 매개변수
Default OFF
Range {OFF, ON}

플래시 출력을 활성화 또는 비활성화합니다. 플래시 신호의 펄스 폭은 한 라인 주기와 같습니다.

FlashPolarity
Type dynamic/static 읽기/쓰기 파라미터
Default LowActive
Range {LowActive, HighActive}

이 파라미터는 생성된 플래시 신호의 극성을 정의합니다.

FlashDelay
Type dynamic/static 읽기/쓰기 파라미터
Default 0
Range {0, 4095}

이 파라미터는 외부 트리거 입력에 대해 생성된 Flash 신호를 지연할 라인 수를 지정합니다. 따라서 플래시를 외부 트리거 입력에 동기화할 수 있습니다.

플래시 신호의 펄스 폭은 한 라인 주기와 같습니다.

SoftwareTrgPulse
Type 동적/정적 쓰기 파라미터
Default
Range {1}

이 파라미터를 1로 설정하면 소프트웨어 트리거가 생성됩니다. 이는 Trigger Mode가 외부 트리거 모드로 설정되어 있고 ImgTrgInSource가 SoftwareTrigger로 설정된 경우에만 유효합니다.

SoftwareTrgInput
Type 동적/정적 쓰기 파라미터
Default
Range {0, 1}

이 파라미터를 사용하면 이미지 트리거 모드 ExternSw_Gate용 소프트웨어 게이트를 생성할 수 있습니다.

ImgTrgIsBusy
Type 동적/정적 읽기 파라미터
Default 0
Range {0, 1}

The ImgTrgIsBusy parameter enables software readout of the busy state for the image trigger. If busy then this parameter is set to 1 to reflect an ongoing image capture. If set to 0 then the operator is not busy.

CC1output
Type 동적/정적 쓰기 파라미터
Default Exsync
Range {Exsync, ExsyncInvert, Hdsync, HdsyncInvert, Flash, FlashInvert, Gnd, Vcc}

이 파라미터는 CameraLink 케이블의 CC1 라인에서 사용할 수 있는 신호를 지정합니다.

CC2output
Type 동적/정적 쓰기 파라미터
Default Exsync
Range {Exsync, ExsyncInvert, Hdsync, HdsyncInvert, Flash, FlashInvert, Gnd, Vcc}

이 파라미터는 CameraLink 케이블의 CC2 라인에서 사용할 수 있는 신호를 지정합니다.

CC3output
Type 동적/정적 쓰기 파라미터
Default Exsync
Range {Exsync, ExsyncInvert, Hdsync, HdsyncInvert, Flash, FlashInvert, Gnd, Vcc}

이 파라미터는 CameraLink 케이블의 CC3 라인에서 사용할 수 있는 신호를 지정합니다.

CC4output
Type 동적/정적 쓰기 파라미터
Default Exsync
Range {Exsync, ExsyncInvert, Hdsync, HdsyncInvert, Flash, FlashInvert, Gnd, Vcc}

이 파라미터는 CameraLink 케이블의 CC4 라인에서 사용할 수 있는 신호를 지정합니다.

ImgTrgDebouncingMaxTime
Type 정적 쓰기 파라미터
Default 65.520 us
Range [0.016, 1000000] us

이 파라미터는 ImgTrgDebouncingTime 파라미터의 최대 시간을 지정합니다. 최대 시간이 짧을수록 디바운싱 Timer를 구현하는 데 필요한 FPGA 리소스가 줄어듭니다.

ImgTrgDebouncingTime
Type 동적/정적 쓰기 파라미터
Default 0.112 us
Range [0.016, ImgTrgDebouncingMaxTime] us

이 파라미터는 입력 이미지 트리거 신호가 트리거로 인식되기 위해 동일한 값을 유지해야 하는 디바운싱 시간을 지정합니다. 디바운싱 시간 내의 빠른 신호 변화는 필터링되어 제거됩니다.

LineTrgDebouncingMaxTime
Type 정적 쓰기 파라미터
Default 65.520 us
Range [0.016, 1000000] us

이 파라미터는 LineTrgDebouncingTime 파라미터의 최대 시간을 지정합니다. 최대 시간이 작을수록 디바운싱 Timer를 구현하는 데 필요한 FPGA 리소스가 줄어듭니다.

LineTrgDebouncingTime
Type 동적/정적 쓰기 파라미터
Default 0.112 us
Range [0.016, ImgTrgDebouncingMaxTime] us

이 파라미터는 입력 라인 트리거 신호가 트리거로 인식되기 위해 동일한 값을 유지해야 하는 디바운싱 시간을 지정합니다. 디바운싱 시간 내의 빠른 신호 변화는 필터링되어 제거됩니다.

사용 예

TrgPortLine 오퍼레이터의 사용법은 다음 예시와 같습니다.